home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / cuserid.0 < prev    next >
Text File  |  1996-09-02  |  3KB  |  55 lines
  1.  
  2. CUSERID(3)                 UNIX Programmer's Manual                 CUSERID(3)
  3.  
  4. NNAAMMEE
  5.      ccuusseerriidd - get user name
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssttddiioo..hh>>
  9.  
  10.      _c_h_a_r _*
  11.      ccuusseerriidd(_c_h_a_r _*_b_u_f)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      TThhiiss iinntteerrffaaccee iiss aavvaaiillaabbllee ffrroomm tthhee ccoommppaattiibbiilliittyy lliibbrraarryy,, lliibbccoommppaatt..
  15.  
  16.      The ccuusseerriidd() function returns a character string representation of the
  17.      user name associated with the effective user ID of the calling process.
  18.  
  19.      If _b_u_f is not the NULL pointer, the user name is copied into the memory
  20.      referenced by _b_u_f. The argument _b_u_f is assumed to point to an array at
  21.      least L_cuserid (as defined in the include file <_s_t_d_i_o_._h>) bytes long.
  22.      Otherwise, the user name is copied to a static buffer.
  23.  
  24. RREETTUURRNN VVAALLUUEESS
  25.      If _b_u_f is not the NULL pointer, _b_u_f is returned; otherwise the address of
  26.      the static buffer is returned.
  27.  
  28.      If the user name could not be determined, if _b_u_f is not the NULL pointer,
  29.      the null character `\0' will be stored at _*_b_u_f; otherwise the NULL point-
  30.      er is returned.
  31.  
  32. SSEEEE AALLSSOO
  33.      getlogin(2),  getpwent(3)
  34.  
  35. SSTTAANNDDAARRDDSS
  36.      The ccuusseerriidd() function conforms to IEEE Std1003.1-1988 (``POSIX'').
  37.  
  38. BBUUGGSS
  39.      Due to irreconcilable differences in historic implementations, ccuusseerriidd()
  40.      was removed from the  standard.  This implementation exists purely for
  41.      compatibility with existing programs.  New programs should use one of the
  42.      following three alternatives to obtain the user name:
  43.  
  44.            1.   ggeettllooggiinn() to return the user's login name.
  45.            2.   ggeettppwwuuiidd(ggeetteeuuiidd()) to return the user name associated with
  46.                 the calling process' effective user ID.
  47.            3.   ggeettppwwuuiidd(ggeettuuiidd()) to return the user name associated with the
  48.                 calling process' real user ID.
  49.  
  50.      The ccuusseerriidd() function uses ggeettppwwuuiidd(); thus the results of a user's call
  51.      to ggeettppwweenntt(), ggeettppwwnnaamm() or ggeettppwwuuiidd() will be overwritten by subsequent
  52.      calls to ccuusseerriidd().
  53.  
  54. BSD Experimental               November 28, 1993                             1
  55.